---
title: 使用 AI SDK 指定任意模型
description: Connect your Agents SDK agents to any model through the Vercel's AI SDK
---

import { Aside, Steps, Code } from '@astrojs/starlight/components';
import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk-setup.ts?raw';

<Aside type="caution">
  此适配器仍处于测试阶段。你可能会在使用某些模型提供方时遇到问题，尤其是较小的提供方。请通过[GitHub
  issues](https://github.com/openai/openai-agents-js/issues)反馈问题，我们会尽快修复。
</Aside>

Agents SDK 开箱即用地通过 Responses API 或 Chat Completions API 支持 OpenAI 模型。不过，如果你想使用其他模型，[Vercel 的 AI SDK](https://sdk.vercel.ai/) 提供了多种受支持的模型，可通过此适配器集成到 Agents SDK 中。

## 设置

<Steps>

1. 安装扩展包以获取 AI SDK 适配器：

   ```bash
   npm install @openai/agents-extensions
   ```

2. 从 [Vercel 的 AI SDK](https://ai-sdk.dev/docs/foundations/providers-and-models) 选择并安装所需的模型包：

   ```bash
   npm install @ai-sdk/openai
   ```

3. 导入适配器和模型以连接到你的智能体：

   ```typescript
   import { openai } from '@ai-sdk/openai';
   import { aisdk } from '@openai/agents-extensions';
   ```

4. 初始化一个模型实例供智能体使用：

   ```typescript
   const model = aisdk(openai('gpt-5-mini'));
   ```

</Steps>

<Aside type="caution">
  我们目前支持 ai-sdk 的模型提供方 v2 模块，它与 Vercel AI SDK v5
  兼容。如果你有特定原因需要继续使用 v1 模型提供方，可以从
  [examples/ai-sdk-v1](https://github.com/openai/openai-agents-js/tree/main/examples/ai-sdk-v1)
  复制该模块到你的项目中。
</Aside>

## 示例

<Code lang="typescript" code={aiSdkSetupExample} title="AI SDK 设置" />

## 传递提供方元数据

如果需要随消息发送特定于提供方的选项，请通过 `providerMetadata` 传递。这些值会被直接转发给底层的 AI SDK 模型。例如，以下在 Agents SDK 中的 `providerData`

```ts
providerData: {
  anthropic: {
    cacheControl: {
      type: 'ephemeral';
    }
  }
}
```

在使用 AI SDK 集成时会变为

```ts
providerMetadata: {
  anthropic: {
    cacheControl: {
      type: 'ephemeral';
    }
  }
}
```
